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New ProDOS Book 


Dennis Doms and Tom Weishaar, Technical Consultant and 
Publisher of Open-Apple, have conspired to bring us an 
interesting new book on programming under ProDOS, especially 
focussing on BASIC.SYSTEM. 


“ProDOS Inside and Out" begins by explaining what an operating 
system is, progresses by describing files and directories, and 
goes on into simple commands. The next sections cover 
Applesoft programming and text file handling, followed by 
information about using machine language under BASIC.SYSTEM and 
uSing the ProDOS Kernel and MLI calls from BASIC. 


This book does an excellent job of introducing the basic 
concepts of ProDOS, and then takes the reader on into quite 
advanced territory. It's very refreshing to find a book that 
doesn't assume you're already an expert and still has enough 
substance to help make you into one. 


“ProDOS Inside and Out", by Dennis Doms and Tom Weishaar, from 
TAB Books. List is $16.95, we'll have it for $16 + shipping. 


Fight Ways to Count Bits in a Byte........Bob Sander-Cederlot 


Of course, there are always eight bits in a byte, by 
definition. But sometimes we want to know how many of those 
eight bits are l's. There are enough reasons to generate this 
count that some computers have a special machine language 
opcode to count the number of l-bits in a byte or word. 


One reason that comes to mind is to compute the odd- or 
even-parity bit for a byte of ASCII data. Another is in 
processing of picture data in a computer vision system. 


I came up with at least eight different programs to count the 
l-bits in a byte. I would choose one based on how critical 
speed Or memory-usage is in a particular case. 


The fastest one, table lookup, can translate a byte toa bit 
count in 4 cycles (7 if you also count getting the byte-value 
into X or ¥. It is fast, but it requires a 256-byte table. 

The table has the counts for each possible value. If speed is 
Critical, I would use this method. I would probably use one of 
the other methods to create the table during initialization, 
rather than assembling it from source code. An example of the 
table lookup method is shown in lines 2130-2160, as a 
subroutine. 


The next method that I thought of is shown in lines 1500-1590. 
I count the l-bits in the X-register, while shifting the data 
byte. The loop runs eight times, once for each bit position. 
This one takes from 86 cycles to 94 cycles, depending on how 
Many l-bits there are. The average time is 90 cycles. (I am 
not counting the JSR and RTS.) 


A slightly faster method checks two bit positions during each 
loop (lines 1610-1730). The reduction in loop overhead changes 
the times to minimun 66, maximum 74, average 70 cycles. 


The fastest method I found without table lookup is shown in 
lines 1750-2010. This one is completely unwrapped, so there is 
no loop overhead at all. The times come out to minimum 43, 
maximum 51, average 47 cycles. 


I tried just optimizing the first method, and lines 2030-2110 
are the result. This one gets more average speed because it 
loops only until there are no more l-bits left. The minimum is 
only 8 cycles (when the byte = $00). If the byte = $80, it 
takes 14 cycles. For $CO or $40, it takes 128 or 120 cycles. 
For values that have bit 0 = 1, it will take from 70 to 77 
cycles, depending on the number of l-bits in the other seven 
bit positions. The overall average is 65 cycles. 


By changing this last method just a little, the overall average 
can be reduced to between 58 and 59 cycles. The result is 
still fairly small, so I think this one would be may favorite 
choice when the blinding speed of a table lookup is not 
necessary: 
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S-C Macro Assembler Version 2-.0...-.-DOS $100, ProDOS $100, both for $120 
Version 2-0 DOS Upgrade Kit for 1-.0/1.1/1.2 ownerS.......ccccccccvccee S20 
ProDOS Upgrade Kit for Version 2-0 DOS OWnersS....ccccccccccccccccccees 930 
Source Code of S-C Macro 2-0 (DOS only)..............-2.--additional $100 
Full Screen Editor for S-C Macro (with complete source code)..........$49 
S-C Cross Reference Utility-..-...without source code $20, with source $50 


RAK-Ware DISASM....-.-.----- eoeeee Without source code $30, with source $50 
S-C Word Processor (with complete source COde) ...cccccccccscccccveccere 9 IU 
DP18 Source ana Object..-... eo eee eereereereesee7ee#e? 66g eB Site ea SERS See OSS cee OU 


Double Precision Floating Point for Applesoft (with source code)......$50 
ES-CAPE (Extended S-C Applesoft Program Editor) .......e. 

Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2-0 and Source Code Update (for Registered Owners)....$30 
Bag of Tricks 2 (Quality Software) ....-........-----06. ecseceee ($49.95) $45 * 
MacASM -- Macro Assembler for MacIntosh (Mainstay).......-. ($150. 00) $100 * 
S-C Documentor (complete commented source code of Applesoft ROMs).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 

(Available: 6800/1/2, 6301, 6805, 6809, 68000, 2-80, 2-8, 8048, 
8051, 8085, 1802/4/5, PDP-ll, GI1650/70, others) 


AAL Quarterly Disks..... Sis She alte Saiteray ee ee ee eee --each $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub rings)...-.. ecccccccccccesecvece package of 25 for $15 * 
Vinyl disk pages, 6"x8.5", hold two disks each..-.....see....-6--10 for $6 * 
Diskette Mailing Protectors (hold 1 or 2 disks).......«.+..+.-.40 cents each 


(Cardboard folders designed to fit 6"X9" Envelopes.) or $25 per 100 * 
Envelopes for Diskette Mailers.............. eo ccccccccceses 6 Cents each 
65802 Microprocessor (Western Design Center) ......ceeccccccccee ($95) $50 * 
quikLoader EPROM System (SCRG).-.-....----ccccccccces eocccceee (S179) $170 * 
PROMGRAMER (SCRG).-..---------.-----2- cece ce ccccrsccccccccse (9149-50) $140 * 
SWitch-a-Slot. (SCRG) ses s2i es siete ied ce eke esasewsasetcwns --- ($179.50) $170 * 
Minuteman 250 Uninterruptible Power Supply....... tee ewan ed eee (S359) $320 + 
"65816/65802 Assembly Language Programming", Fischer........($19-95) $18 
“Programming the 65816", Eyes........-.... Tee eate cee ewes leeec9o) “92. 
“Apple //e Reference Manual", Apple Computer........... oeeee ($24.95) $23 


"Apple //c Reference Manual", Apple Computer........-.esccee- ($24.95) $23 
“ProDOS Technical Reference Manual“, Apple Computer.........($29-95) $27 
“Apple ProDOS: Advanced Features for Programmers", Little..($17.95) $17 


“ProDOS Inside and Out", Doms & WeiShaar.........-..-. eoceeee ($16.95) $16 
“Beneath Apple ProDOS", Worth & Lechner.......ceeeees occeeee ($19-95) $18 
"Beneath Apple DOS", Worth & Lechner......--.---... eocccccee ($19-95) $18 
“Inside the Apple //c", Little..-........... ee ooceeee (919-95) $18 


“InsiGce’ the Apple 7/6". Littless<s 6 s2e shes bi scecewtwiecs eee ($19-95) $18 
“Understanding the Apple //e", Sather... ...cewcccccccsncccee ($24-95) $23 
“Understanding the Apple II", Sather..-...cccccccccccveceees ($22.95) $21 
"Apple II+/IIe Troubleshooting & Repair Guide“, Brenner.....($19-95) $18 
“Apple J[ Circuit Description", Gayler.............--4- eoeee ($22.95) $21 
“Assem- Language for Applesoft Programmers", Finley & Myers.($18-95) $18 
“Enhancing Your Apple II, vol. 1", Lancaster..-.. ieee eedewe (SL9.99). 2S15 
“Enhancing Your Apple II, vol 2", Lancaster..-.....eeeeeeee ($17.95) $17 
“Assembly Cookbook for the Apple II/IIe", Lancaster........-($21.95) $20 
“Real Time Programming -- Neglected Topics", Foster......ee.+($9-95) $9 
“Microcomputer Graphics", MyerS......-.-----se-ee0. eoccccceee (S14-95) $14 
"Assembly Lines -- the Book“, Wagner..-.....-.c.ceeees oceeeee ($19.95) $18 
"AppleVisions", Bishop & GrOSSDerger....cccccccccccccceccees (939-95) $36 


ceeeeeeennen eee ee ee ee He HH H 


* On these items add $2.00 for the first item and 
$-75 for each additional item for US shipping- 
+ Inquire for shipping cost. 
Foreign customers inquire for postage needed. 
Texas residents please add 6 1/8 % sales tax to all oraers. 


*** S-C SOFTWARE, P- O- BOX 280300, Dallas, TX 75228 *** 


salad (214) 324-2050 wee 
*** Master Card, VISA, Discover and American Express *** 
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COUNT LDX #0 


LDA BYTE 

BEQ .3 value is 00000000 

BPL .2 bit 7 = 0 
ol INX count the l-bit 
02 ASL shift the value 

BMI .1 eee-its 1, count it 

BNE .2 »-eits 0, do not count 
3 RTS finished 


Lines 2270-2460 implement still another method, which always 
takes 57 cycles regardless of the mix of zeroes and ones. It 
useS an extra pagezero location for a temporary cell. The TAX 
in line 2450 is required only if it is really required that the 
- bit count be returned in the X-register. My test program has 
this requirement, but there is no reason to force that 
requirement on a real program. If the A-register is good 
enough, then this method only takes 55 cycles. 


Lines 2180-2250 are “half" a table lookup. That is, I am uSing 
half a table: entries for values from $00 to S7F. This is a 
tiny bit slower than the full table lookup, but saves 128 bytes 
of table. I shift the value right one bit position, guaran- 
teeing a value from $00 to S$7F, and save the bit shifted out in 
carry. Then adding carry to the value from the table gives me 
the count for the whole original value. A slight change to how 
carry is added can reduce the average time by half a cycle: 


COUNT LDA BYTE 
LSR 
TAY 
LDX TBL1,Y 
BCC .1l 
INX 

ol RTS 


The wildest way I came up with is based on one I read about in 
the latest issue of Byte magazine (the IBM special issue, in 
the BIX section). By masking, adding, and shifting, the bits 
can be all aligned and added into a count. Lines 2480-2720 are 
my code for this method. The time is 58 cycles, regardless of 
the 0/1 mix. 


I wrote a test routine, so I could tell whether my methods 
really worked or not. Lines 1070-1480 call each of three 
different bit-counters for every possible value of the byte. 

It keeps calling the first method until I hit the space bar, 
and then advances to the second method. Then it keeps calling 
the second, until another key-tap advances it to the third 
method. I can keep cycling through the methods this way, until 
I type a RETURN to end it. Inside each of the three loops I 
have a "LDA $C030" instruction, to toggle the speaker. The 
three loops are identical in timing except for the bit-counting 
code itself. The result is that I can tell by "ear" which 
methods are fastest, and which ones have a constant time 
regardless of the 0/1 mix. I tested the accuracy by comparing 
the results in TBL1 and TBL2 with the monitor “V" command, and 
by displaying the TBL using the monitor. 
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Apple Assembly 


SAVE S.BIT COUNTERS 


SUM1 oE 
SUM2 ~ EQ 
(ER een mares 
T 
00 LDA 
STA 
| Seep ene asic eee 
56 1 JSR 
00 LDY 
TXA 
00 STA 
0 LDA 
0 INC 
00 LDA 
ED BPL 
0 STA 
D CMP 
37 . BEQ 
64 2 JSR 
00 LDY 
TXA 
00 STA 
0 LDA 
0 INC 
00 LDA 
ED BPL 
10 STA 
8D CMP 
1D P BEQ 
76 23 JSR 
00 LDY 
TXA 
00 STA 
0 LDA 
0 INC 
00 LDA 
ED BPL 
10 STA 
8D CMP 
03 ‘ BEQ 
O4 JMP 
399 RTS 
COUNT. 1 
08 LDY 
00 LDX 
00 LDA 
Pa | ASL 
01 BCC 
INX 
2 DEY 
F9 BNE 
RTS 
225-4 Ss 
COUNT.2 
O04 LDY 
00 LDX 
00 LDA 
1 ASL 
01 BPL 
INX 
01 ve BCC .3 
INX 
e 3 ASL 
DEY 
F5 BNE 
RTS 
Line..-.December, 1986 


COUNT. 3 
E 
TBL2,Y 
c036 
YTE 
$c000 
a3 
C010 
sor 
9 
TEST 1 BIT AT A TIME, 
0 LOOPING 8 TIMES 
BYTE 
IF BIT = 1, COUNT IT 
NEXT BIT 


TEST 2 BITS AT A TIME, 


LOOPING 4 TIMES 


IF BIT = 1, COUNT IT 
IF BIT = 1, COUNT IT 


NEXT PAIR OF BITS 
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Personalize and 
Protect your Apple 
with the 


Banong Chip 


When you turn on your Apple’, this 
remarkable new ROM replacement 
will display your name or personalized 
message with optional password 
protection. 


| 
CALL TOLL FREE: 
1-800-843-0975 


Nationwide 


1-800-443-9060 


Azure Mountain —_ 
Products 


14755 Ventura Bivd., Ste. 1483 Sherman Oaks, CA 91403 


1740 

1750 COUNT. 3 
0876- A2 0 1760 X #0 
0878- A5 00 ie LDA BYTE 
O87A- 10 17380 BPL .1 
087C- E8 13D INX 
O87D- 4A 1800 .1 LSR 
O87E- 90 01 1810 BCC .2 
0880- E8 1820 INX 
abate 4A 1830 22 LSR 
0862- 90 01 1840 BCC .3 
O884- E8 1850 INX 
0885- 4A 1860 .3 LSR 
0886- 90 01 iets BCC .4 
0888- E8 1880 INX 
O889- HA ioe 24 R 
O88A- 90 01 1900 BCC .5 
O88C- E8 1910 INX 
O88D- 4A 1920 .5 LSR 
O88E- 90 01 Zee BCC .6 
0890- E8 1940 INX 
0891— 4A 1950 .6 LSR 
0892- 90 01 1960 BCC .7 
O894- E8 Leh INX 
0895- 4A 1980 .7 LSR 
0896- 90 01 1990 BCC .8 
0898- E8 2000 INX 
0899- 60 2010 8 RTS 

aa COUNT. 4 
O89A- A2 00 20 #0 
O89C- A5 00 2050 LDA BYTE 
O89E- FO 06 2060 BEQ . 
O8A0- 10 01 2070 .1 BPL . 
O8A2- E8 20 INX 
O8A4- DO FA 2100 BNE .1 
O8A6- 60 2110 2 RTS 

itn COUNT.5 
O8A7- AX 00 21 BYTE 
O8A9- BE 00 OA 2150 LDX TBL1,Y 
O8AC- 60 2160 RTS 
O8AD= A5 00 219 BYTE 
O8AF- HA 2200 LSR 
O8BO— AA 2210 TAX 
O8Bi=- AQ 00 2220 LDA #0 
08B3- 7D 00 OA 2230 ADC TBL1,X 
O8B6—- AA 2240 TAX 
O8B7- 60 22 RTS 

Soke COUNT .7 
O8B8- A5 00 2250 LDA BYTE 
O8BA- 4A 2290 LSR 
O8BB- 85 01 2300 STA B 
O8BD- AJ 00 2310 LDA #0 
O8BF- 2A 2320 ROL 
O8CO- 46 01 2330 LSR B 
08C2- 69 00 2340 ADC #0 
O8CH—- 46 01 2350 LSR B 
O8C6—- 69 00 2360 ADC #0 
O8CB8- 46 01 2370 LSR 
O8CA- 69 00 2350 ADC #0 
O8CC= 46 01 2390 LSR 
O8CE- 69 00 2400 ADC #0 
O8D0=- 46 01 2410 LSR 
O8D2- 69 00 2420 ADC #0 
O8D4- 46 01 2430 LSR B 
O8D6- 65 01 2440 ADC B 
O8D8— AA 2450 TAX 
O8D9- 60 2460 RTS 


NO LOOPS, JUST STRAIGHT-LINE CODE 


BIT 7 


BIT 0 


BIT 1 


BIT 2 


BIT 3 


BIT 4 


BIT 5 


BIT 6 


UPR NW Pow 


w 
| 
a | 
Sn MN & WwW NH — 


2480 COUNT.8 
90 LD 


O8DA=- A5 00 24 A BYTE 
O8DC- 29 55 2500 AND #$55 BITS 6,4,2,0 
O8DE- 85 01 2510 STA SUM1 
O8EO- 45 00 2520 EOR BYTE BITS 7,5 
O8E2- 4A 2530 LSR CLEARS "2ARRY 
O8E3- 65 01 25 ADC SUM1 FORM Piglet where each pair 
O8E5—- 85 01 2550 STA SUM1 » or 2. 
O8E7- 29 33 2560 AND #$33 iséiate "bossooee 
OSE9- 85 02 2570 STA SUM2 
O8EB- 45 01 2580 EOR SUM1 Isolate ww0O0yy00 
O8ED—- 4A 2230 LSR 
O8EE- 4A 2600 LSR Now it is OOww00yy 
O8EF- 65 02 2610 ADC SUM2 Form Quuu0vvv, where each group 
O8F1- 85 02 2620 STA SUM2 is 0, 1. 2. 3. or 4. 
O8F3- 29 OF 26 30 AND #$0F Isolate 00000vvv 
O8F5- 85 01 2640 STA M1 
O8F7=- 45 02 2650 EOR SUM2 Isolate Ouuu0000 
O8F9- HA 2660 LSR 
O8FA- 4A 2670 LSR 
O8FB=- 4A 2680 LSR 
O8FC- re 2690 LSR Now it is 000QQuuu 
O8FD- 65 01 2700 ADC SUM1 Form count 0-¢ 
O8FF- AA 2710 TAX 
0900- 60 2720 RTS 
2730 Bmmmm nnn ne eee ee ne eee 
090 1- 2740 -BS #4+255/256 #256- 
2750 Bannan nn aee eer e new nen esenaaas 
OA00- 60 TBL1 -BS 256 
OBO0- 0 TBL2 -BS 2 


ACCEPT NO SUBSTITUTES. 
BECAUSE THERE AREN'T ANY. 


There's only one card like RamWorks. We’ve got the best hardware 
design. We supply the best software and we’ve got the best support from 
software companies. 


If someone tempts you with an imitation, please get both sides of the 
story. You'll discover why RamWorks offers the best enhancements to 
AppleWorks and other programs, and at the lowest price. 


GUARANTEED! 


214-241-6060 Va = 


“We Set the Standard” 
9 AM - 11 PM APPLIED ENGINEERING 
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Apple //gs ROM Checksummer.........e+e++.2+e+eBOb Sander-Cederlof 


Somewhere I ran across a statement that the 128K bytes of ROM 
in the //gs have a standard checksum. A value is Stored at 


SFFFFF6 and S$FFFFF7 to pad out the checksum, so that it will 
always add up to $1234. I tried various ways of adding up the 
bytes to get that value, and came up with the following little 
program. 


1000 SAVE S. CHECK SUM 
1010 # 


‘n50 -OP 65816 

10h0 FORM. AND.DISPLAY. ee CHECK SUM 
000800- 18 1050 CLC ENTER NATIVE MODE 
000801- FB 1060 XCE 
000802- C2 30 i 5 REP #$30 FULL 16 
OOO804- A2 00 00 1090 LDX ##0 0 TO FFFF 
OO00807- 8A 1100 TXA START WITH A=0 
000808- 38 1110 SEC WHY? IT MAKES ANSWER $1234 
000809- 7F 00 00 FE 1120 .1 ADC $FE0000,X BANK $FE 
OO0O80D- E8 iro INX 
OOO80E- E8 1140 INX TWO BYTES AT A TIME 
OOOSOF= DO F 1150 BNE .1 -UNTIL WHOLE BANK 
000811- 7F 00 00 FF 1160 .2 ADC $FF0O000,X BANK $FF 
000815- £8 Abe INX 
000816- E8 1180 INX TWO BYTES AT A TIME 
000819- 85 00 oan P STA 0 SAVE RESULT AT $00,01 
00081B- 38 1220 SEC EMULATION MODE 
00081C- FB ieee XCE 
00081D- A5 01 1240 LDA 1 PRINT CHECKSUM WITH OLD MONITOR 
00081F- 20 DA FD 1250 JSR $FDDA SUBROUTINE 'PRBYTE' 
000822- A5 00 1260 LDA 
000824- 20 DA FD 1270 JSR $FDDA 
000827- 60 1280 RTS 

1200 Wee se seat cee 


The 128K ROM occupies the space from $FE0000 through SFFFFFF. 
My program adds up the data there two bytes at a time in 16-bit 
registers. Doing a normal add of these "words" gave a sum of 
$1233, so I started with SEC instead of CLC to get a sum of 
$1234- I took my program to a computer store and tried it ona 
"real" //gs, with a different ROM set, and got the same result: 
$1234. 


If you make any changes to the ROMS yourself, be sure to fix 
the checksum too. Otherwise you may not even be able to boot! 


Who Worked on the //gS?....cceccceeceeeeeeBOD Sander—Cederlof 


You can see a list of the names of the people inside Apple who 
worked on the //gs by typing in the following program. The 
names are stored inside the //gs ROM, organized according to 
which project they worked on. I suppose future versions of the 
//gs ROMS may not have this information (they may need the 
Space for more useful tools), or it may be moved around, but so 
far it is all the machines I have looked at. 
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The names start at S$BAOB, and are in two consecutive blocks 
terminated by a 00 byte. Most of the bytes are ASCII 
Characters with bit 7 high (=l1). Whenever you find a byte with 
bit 7 low (=0), it is a repeat count for the following 
Character. Thus 07 AO means repeat $A0 seven times, or print 
seven blanks. You will also find repeat counts followed by 
$53, which is an inverse S. However, in MouseText, it is a 
horizontal line. Evidently it is supposed to be displayed with 
MouseText turned on. 


There may be a program somewhere inside the ROM that prints the 
list of names, but I haven't even tried finding it yet. 
Anyway, the following one will do it. 


1000 *SAVE S. NAMES. IIGS 
1929 # PRINT NAMES OF APPLE //GS DEVELOPERS 
090 teenmen nnn nnn enn enone ewe nena 
1040 .OP 65816 
1080 PRINT NAMES .OF APPLE. PEOPLE 
000800- 18 1080 CLC ENTER NATIVE MODE 
000801- FB 1090 XCE 
000802- C2 10 1100 REP #$10 X.Y 16-BIT MODE 
000804~- AQ 8D 1101 LDA #$8D SKIP TWO LINES 
000806- 20 3B 08 = 1102 JSR MY.COUT 
000809- 20 3B 08 1103 JSR MY.COUT 
O0080C- A2 OA BA 111 LDX ##SBA0A NAMES START AT $BAOB 
OOO80F- 20 18 08 1120 JSR PRINT.NAMES FIRST BLOC 
000812- 20 18 08 1130 JSR PRINT.NAMES SECOND BLOCK 
000815- 38 1140 SEC 
000816- FB 1150 XCE BACK TO NATIVE MODE 
000817- 60 1190 RTS 
1200. ®2cS3e 8 ease eect acSceee saeco 
1210 PRINT. NAMES 
000818- E8 1220 .1 INX NEXT CHAR 
000819- BF 00 00 FF 1230 LDA $FF0000,X 
00081D- FO 0 12h0 BEQ .2 ..eEND OF A BLOCK 
00081F- 10 0 1250 BPL .3 ..» REPEAT COUNT 
000821- 20 3B 08  ~—=1260 JSR MY.COUT PRINT THE CHAR 
000824- 80 F2 1270 BRA .1 
000826- 60 1280 2 RTS RETURN 
000827- A8 1320 .3 TAY REPEAT COUNT TO Y-REG 
000828- E8 1340 INX 
000829- BF 00 00 FF 1350 LDA fEFQ000, x GET REPEATED CHAR 
00082D- C9 53 1351 CMP #$53 MOUSE TEXT LINE? 
00082F- DO 02 1352 BNE . .. NO 
000831- A9 1353 LDA #"-" ... YES, SUBSTITUTE DASH 
000833- 20 3B 08 =: 1360.4 JSR MY.COUT PRINT THE CHAR 
00083b- 88 1370 DEY N TIMES 
000837- DO FA 1380 BNE .4 
000839- 80 DD 1390 BRA .1 
(HOO, Wseeceee ns ocetscescecesesojscese 
1410 MY. COUT 
00083B- 48 1420 PHA SAVE EVERYTHING!!! 
00083C- DA 1830 PHX 
00083D- 5A 140 PHY 
00083E- 08 1450 PHP 
00083F- 38 1460 SEC EMULATION MODE 
000840- FB 1470 XCE 
000841- 08 1480 PHP 
000842- 20 ED FD _——: 1490 JSR $FDED 
000845- 28 1500 PLP ORIGINAL MODE 
000846- FB 1510 XCE 
000847- 28 1520 PLP RESTORE REGISTERS 
000848- 7A 1530 PLY 
000849- FA 150 PLX 
OOOB4A- 68 1550 PLA 
O0084B- 60 1560 RTS 
1570 Saeweseencaducctiesbeuscssasossss 
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7 Megilie/1Meglic 


Want the best & easiest-to-use (most support) RAM card 
on the market — at the best price? Buy Checkmate 
Technology’s State-of-the-Art MULTIRAM RGB RAM 
CARD™ from us w/BATTERY BACKED-UP RAM options 
that save programs like AppleWorks for 10+ years! FAST 
CHEAP REPLACEMENT FOR HARD DISKS, USER EX- 
PANDABLE TO 7 MEGABYTES, compatible with all (100%) 
3rd party software/hardware, optional 65C8 16 Co-Processor 
card ($147), sharp 80 columns/Double Hi-Res, & FREE 
RGB?! It’s a direct substitute for Ramworks I-III" by Applied 
Engineering (also known as Preferred Computing) or Apple 
80 col cards, has a 55 YR WARRANTY, 15 day money back 
guarantee, & FREE AUTOMATIC SOFTWARE UPDATES 
ONLY FROM US! 


MuitiRam RGB expands to 1 Meg RAM + optional 4 Meg’s 
MultiRam Pius BATTERY PROTECTED RAM. Optional 2 
Meg’s STATIC RAM here soon — for a total of 7 megabytes! 
MuiltiRam lle expands to 768k. And the software & manual 
is the best on the market! 


FREE APPLEWORKS EXPANDER SOFTWARE WITH 
EVERY CARD — loads ALL versions of Appleworks (in 30 
seconds w/AW 2.0), even printer routines, runs faster, expands 
Desktop over 2048k, stores 23,000+ records & 4,800+ word 
processor lines, auto-segments large files onto multiple disks! 
FREE AW TIME/DAY/DATE ON-SCREEN w/ clock, AUTO- 
COPY TO RAM, PRODOS/DOS 3.3. RAM DISK & RAM TEST. 
Optional CP/M & Pascal Ram disks ($20/ea)! 


MultiRam 
RGB Card 


MultiRam 
tle Card 


64k MultiRam 
320k MultiRam 
576k MultiRam 
832k MultiRam 
1024k MultiRam 
MultiRam 
Plus Piggyback 
256k MultiRamPlus ... 220. ... 
512k MultiRamPlus ... 269. ... 
768k MultiRamPlus ... 
1024k MultiRamPlus ... 
2-4 meg MultiRamPlus ... 
Battery/AC Kit (for Plus) 


Apple lle Enhancement Kit 62. 
Cermetek 1200 Baud internal modem lle/li+/ligs . 179. 
Incomm 2400 Baud external univ. modem t 
Clockworks Clock (Thunder/Time HO™ compat) . 

13” RGB Monitor (free cable) 

ProAPP 10/20 Meg Hard Disks (+ FREE software) . 
Apple Compatible Drives Ile/II+ (ligs/llc +15) 
NETWORKING UP TO 256 APPLE lic/Ile/ligs .... 


Terms: Add $4-Ground or $6-Air shipping & phone # to each U.S. 


MultiRam card order (foreign orders/FPO/APO extra). Add 3% for 
MasterCard/Visa (include #/expir) & P.O.’s. For fast delivery send 
Cashier’s/Certified check/Money Order. C.0.D. (add $6) & per- 
sonal checks accepted (allow 16 days). Tex res add 7 ¥4% tax. 


COIT VALLEY COMPUTERS 


Checkmate Technology’s MultiRam CX card easily ex- 
pands your llc to 640k and has a CX+ Piggyback to add 
another 512k (over 1152k total)! It's 100% compatible with 
all llc software/nardware & upgradable with a 65C816 kit 
($105) — all using about 50% less power than Z-RAM! It has 
the SAME FREE SOFTWARE/UPDATES & 5 YR WAR- 
RANTY AS Ile CARDS. 


256k MULTIRAM CX 
512k MULTIRAM Cx 


256k MULTIRAM CX+ 
512k MULTIRAM CX+ 


AutoWorks (Best AppleWorks Macro+) ... 
1200 Baud lic Modem (+$20/cable) 
Clip-on tic Rechargable Battery 

lic Flat Panel Display (C-Vue) 

lic System Clock 


WHY BUY FROM COIT VALLEY COMPU- 
TERS RATHER THAN SOME MAIL ORDER 
HOUSES? Only we offer a 15 day MultiRam 
complete money back satisfaction guaran- 
tee, extra software, more support, free auto- 
matic software updates, free 64k w/ each 
256k/512k/768k lle/RGB card. We know the 
products, & stock them for fast shipping! CALL 
FOR QUESTIONS, PRICES, DISCOUNTS. 
SCHOOLS & GROUPS WELCOME. 


Autoworks, Ramworks IH/Timemaster It H.O./Z-ram, respective trademarks of Software Touch, Applied 
Engineering. *Call for RGB Connectors/cabies (not included). 


ORDER NOW! 


COIT VALLEY COMPUTERS = (214) 234-5047 
14055 Waterfall Way Dallas, Texas 75240 


NAME Sr eee) 
ADDRESS pe a ae a eS 
CITY 


PHONE ( Se ee a 
SIGNATURE 


QTY| DESCRIPTION [PRICE | 


14055 Waterfall Way 
Dallas, Texas 75240 


(214) 234-5047 
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Commented Listing of ProDOS, $DE0O0-DEF2.....Bob Sander-Cederlot 


What happens when you call ProDOS MLI? In assembly language, 
MLI calls look like this: 


JSR S$BFOO 
-DA #command, IOB.Address 


The instruction at $BF0O0 is a “JMP SBFB7" in ProDOS 1.1.1; it 
is possibly different in other versions. All of the following 
disassembly is for ProDOS 1.1.1. The changes in the new ProDOS 
1.2 are minor, and if you have 1.2 you should be able to figure 
out what they are. 


At SBFB7 there is some code I call LC-BRIDGE.ENTRY- It 
“remembers” what language card areas are switched in at $pD000 
and at $E000, and then turns on the language card so that it 
can jump into the MLI call processor. 


BFB7: SEC Set flag 

ROR MLI.ACTIVE.FLAG 
LDA $E000 

STA E000.BYTE (BFF4) 
LDA $D000 

STA DOOO.BYTE (BFF5) 
LDA $CO8B 

LDA $CO8B 

JMP $DE00 


Now comes the good part. The following listing is of the code 
starting at $DE00, which decodes the bytes following your JSR 
SBF0OO and performs your request. 


Lines 1010-1080 define some page-zero variables used by MLI. 
Lines 1090-1220 define some items in the system global page. 
Lines 1230-1280 define some entry points inside the rest of 
MLI, not listed here. 


MLI calls don't change the X and Y registers, so they are saved 
at line 1390. The return address (of the JSR SBFO00) is pulled 
off the stack and saved at PARM.PNTR in page zero, so that it 
can be used to access your command code and IOB address. Lines 
1410-1490 also compute the address of the next instruction, to 
be used later for a return address. This address is saved in 
the system global page, and is useful sometimes for debugging. 
(We have published several articles on enhanced error messages 
and tracers for MLI calls in previous issues of AAL.) 


Lines 1500-1650 convert the command code to an index by a 
strange scheme. The legal command codes are (in hex): 40, 41, 
65, 80 thru 82, and CO thru D3- The hashing algorithm used 
here adds the high nybble of the command code to the whole 
code, and then masks it to the lower five bits. This 
compresses the range of the codes, without any overlapping. 


40,41 --> 04,05 CO-CF --> OC-1B 
65 --> OB DO-D2 --> 1D-1F 
80-82 --> 08-0A D3 --> 00 
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The first clock 


card to add time 
and date to. 
AppleWorks’ 


screens and files. 


Timemaster H.O. So many 
features its become the world’s 
best selling clock card. 


tS the smart way to put the Gime and date on vour Apple 

He* or d+" Because only the Timemaster FLO, packs 
ALL the important features of all the competition combaied. 
including leap vear. vear Cnot just in PRO-DOs), month, 
cate. daw of week, hours. minutes. seconds and mill 
seconds. Its totally PRO-DOS, DOS 3.3. PASCAL and CPM 
compatible. And. of course, it works better than any other 
clock with AppleWorks. 

With the Timemaster 1LO. voure assured of reliable, 
trouble-free operation dong with simple. ong-command 
lime setiing. accuracy through leap vears, anda firmware 
maintuned interrupt setaing. 

If vou re using or writing software for other clock 
cards, vou're still covered. Because the FLO. will aadfonmat 
ically emulate them. And only the Timemiaster HELO, adds 15 
new commands to BASIC, The HO. even comes complete 
with awo disks full of sample programs, including a comput 
erized appointment book, 2 DOS dating program, interrupt 
programs, and over 30 programs that others charge vou 
extrafor or don teven offer As a low-cost option, vou 
cainadd true BSR remote control to the FEO. giving vou 
remote control of up to 16 lights and appliances in vour 
home or office. 

° Time in hours. minutes. seconds and milliseconds: date 


Oa beets 


$129.00 
$ 39.00 


Call to order today, 92am. to TH pam. seven days. or 
send check or money order to Applied Engineering. Master: 
Card, VISA and C.O.D. welcome Texas residents add 3! s% 
sales tux, Add $10.00 outside ULS.A, 


Ta Applied Engineering 
The Apple enhancement experts. 


P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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Vieuwmaster 8O 


Now run 
AppleWorks on 
your II+and keep 
full 80 column 
compatibility! 


UY 


C) ne look at the chart will give vou some of the 
reasons there's only one smart choice in 80 
column cards for your Apple. But the real secret to 
Viewmaster 80's success is something even better: 
Total compatibility. 

Each Viewmaster 80 includes our powerful Apple- 
Works expand software, allowing AppleWorks to run on 
the II + with only 64K (or more) memory. (We recom- 
mend the RamFactor memory card, but any compatible 
Apple memory card will work.) The software provides 
our full range of AppleWorks enhancements, including 
expanded records, word processor, multi-disk saving, 
time and date display on screen with any PRO-DOS 
clock, and more! 

The Viewmaster 80 works with all 80 column 
applications, including DOS 3.3, PRO-DOS, CP/M, 
Pascal, WordStar, Format I, Applewriter IH, dBase IL, 
Visicalc, Multiplan, and bundreds of others —- includ- 
ing AppleWorks. 

Here are just a few of the powerful features the 
Viewmaster 80 delivers for a great price ($139): 

° 80 Characters by 24 lines ¢ Fully compatible with all 
Apple languages and software * Highest compatibility 
with existing 80 column software ¢ Very low power con- 
sumption * High speed (18 MHZ) scroll rate * Upper and 
lower case characters and true descenders, both inverse 
and normal, all on-screen editing functions are sup- 
ported ¢ User-definable cursor shape * Compatible with 
Apple II, I+ and Ile ¢ Five-year warranty 

Call today to order or for more information, 9 a.m. 
to ll p.m. seven days, or send check or money order to 
Applied Engineering. MasterCard, VISA and C.O.D. wel- 
come. Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A. 


Fa a Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


This index is used then to look into the COMMAND.HASH.TABLE, 
which has the actual command codes in the indexed positions. 
If the original code is not found there, then the original code 


was an illegal command number. The hash index is also used to 

look up the parameter count in PARM.CNT.TABLE. I have appended 
the code for these two tables to the end of today's listing, at 
lines 3100 to the end. 


Lines 1810-1920 branch various ways according to the command 
code. Most of the commands are not shown in this listing, but 
most of the code for READ BLOCK and WRITE BLOCK is shown (lines 
2690-3080). When a command is finished, it eventually finds 
its way back to EXIT.TO.CALLER at line 2180. 


Lines 2180-2560 get us back to our own code again, after the 
JSR SBFOO. If the MLI call produced an error, the code number 
for that error will be in SYS.ERRNUM. The error code will be 
returned in the A-register, with carry SET. If there is no 
error to report, A=0 and carry is clear. 


We will probably be presenting more sections of MLI disassemply 
in the near future. You may remember that we published 
portions of an earlier ProDOS version back in November and 
December of 1983. 


Yee ®SAVE S.MLI.DEOO.DEF2 
H0- 1020 PARM.PNTR .EQ $40.41 
h2- 1ORO COMMAND -EQ $42 
43- 1040 UNIT.NO -EQ $4 
yh 1pe BUFF.PNTR .EQ $44, 45 
N6- 1060 BLOCK .NO -EQ $46.47 
N8- ake GEN.PNTR1 .EQ $48,49 
NE- : ae GEN.PNTR2 .EQ $4E,4F 
BFO3- i080 C CALL. QUIT ~-EQ $BFO 
BF06- 1110 CALL. TIME ~-EQ $BFO 
BFO9- 1120 CALL.SYSERR -EQ $BF09 
BFOF- M98 SYS. ERRNUM - EQ 
BF 10- 1140 DRIVER. ADDR. TABLE -EQ $BF10 thru BF2F 
BF95- 1150 BACKUP.BIT - EQ F95 
BF9B- 1160 MLI.ACTIVE.FLAG -EQ $BF9B 
BF9C- te MLI. RETURN -EQ $BF9C.D 
BFIE- 1180 MLI.X - EQ F9E 
BFOF- 1190 MLI.Y -EQ $BF9F 
BFAO- 1200 LC.BRIDGE.EXIT -EQ $BFAO 
BFF4- 1210 E000. BYTE -EQ $BFF4 
BFF5- Uae DOOO. BYTE -EQ $BFF5 
DEF 3-= 1240 INTERRUPT.HANDLER -EQ $DEF3 
EO4UT- 1250 FILING. FUNCTIONS -EQ $E04 
FCOF- ‘ ae CHECK . IF.MEM. FREE -EQ $FC9 
FEF5- 1380 JUMP EQ $FEF5.6 
1300 -OR $DE00 
1330 : -TA $800 
1330 # JSR $BFOO comes here 
1340 # -DA #$xx command byte 
1326 ; -DA xxxx IOB Address 
ihe MLI. ENTRY 
DEOO=- D8 1380 
DEON. BE SE Br 100 STX MLI.Y 
DEOT=- 88 1410 PLA GET RETURN ADDRESS 
DEO8—- 85 40 1420 STA PARM.PNTR WILL POINT AT BYTES 
DEOA- 18 130 CLC FOLLOWING JSR aoree 
DEOB- 69 0 1440 ADC #4 COMPUTE ACTUAL RETURN 
DEOD- 8D 9C BF 1450 STA MLI. RETURN AND SAVE FOR LATER 
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DE10=- 68 1460 PLA 
Bers: 69 83 inde Rt gms Pune 
DE15= 8D 9D BF 1490 STA MLI. RETURN+1 
1500 #---Check Command Code----------- 
DE18= AO 00 1510 LDY #0 
BET De a OF BF eee ay SYS. ERRNUM 
DE1E- B1 40 12ho LDA (PARM.PNTR).Y 
DE20- 4A 1550 LSR Hash it (CC/16 + CC) & $1F 
DE21—= 4A 1560 LSR 
DE22= 4A ea LSR 
DESR- 18 1390 cic 
Beers 23 1p SRG game 
DE29—- AA 1949 TAX Use hashcode as index 
DE2A- B1 40 10.30 LDA (PARM.PNTR).Y Original command code 
DE2C- 65 FD 1640 CMP COMMAND. HASH. TABLE, X 
DE2F= DO 76 1990 BNE ERR.CALL.NO Not valid command 
1660 #---Get IOB Address-------------- 
DE31—- C8 Joye INY 
DE32= B1 40 1680 LDA (PARM.PNTR).Y 
a 
DE36= B1 40 1710 LDA (PARM.PNTR).Y 
peaee 8° 44 N20 STA PARM. PNTR+1 
DE3B- 85 40 1Fh0 STA PARM.PNTR 
1750 #---Check Parm Count------------- 
DE3D= AO 00 1760 LDY #0 
DE3F- BD 85 FD 1770 LDA PARM.CNT. TABLE, X 
DE42= FO 1C 1780 BEQ MLI.GETTIME ---only one with O parms 
DE44- D1 40 17.90 CMP (PARM.PNTR).Y 
DE46- DO 63 1800 BNE ERR. PARM.CNT 
19.10 #~--Branch Various Ways oo-------- 
pense ap go rm iaag REE sit ARSR- rac 
Cea a OE elt pee 1 ~» QUIT CALL 
DE50= 10 14 1320 BPL MLI.RWBLK 80 or $81 
DE52=- BO 1D 1870 BCS MLI.CX. AND.DX Cx or $Dx 
eee 1Bo0 AND #$0 ee ona 
DE {- $6 F DE 1 80 JSR #50) RUPT. HANDLER 
DE5A- AC DE 1910 JMP BET PO TRA LEER 
DE5D=- 4C 03 BF 1850 3! JMP CALL.QUIT $65 
13i0 # Command $82. Get the Date and Time 
1960 MLI.GETTIME 
DE60= 20 06 BF 137° JSR CALL. TIME 
DE63—- 4C 78 DE iocG ‘ JMP EXIT.TO.CALLER 
ence # Commands $80 and $81 
2020 MLI. RWBLK 
DE66—- 4A 2030 LSR Make $00 and 01 
DE67=- 69 01 2040 ADC #1 Into $01 and 02 
DE69=- 85 42 2050 STA COMMAND Store into command block 
DE6B- 20 B2 DE 2060 JSR BLOCK.IO.SETUP Do the I/0 
DE6E=- 4C 78 DE Sn JMP EXIT.TO.CALLER 
e030 # Commands $CO thru $D3 
2110 MLI.CX. AND. DX 
DET1—- 4A 2120 LSR Make command code into 
Cee a 1F 7 0 a #31F an index 
DE7T5= 20 47 EO 2150 JSR FILING. FUNCTIONS 
2160 #---fall into EXIT routine------- 
2170 * (DE78) DE5A DE63 DE6E DEBO callers 
2180 EXIT.TO.CALLER 
DE78= AQ OO 2190 LDA #0 Clear BACKUP bit 
DETA- 8D 95 BF 2200 STA BACKUP.BIT 
DE7D= AC OF BF 2210 LDY SYS.ERRNUM If any error code, 
DE80- CO 01 2220 CPY #1 then set carry 
DE82= 98 2230 TYA and clear Z-bit 
DE83- 08 2240 PHP Save this status 
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RamWorks III 


Patented Performance from the Recognized Leader 


With battery backed RAM port, RGB port, increased memory capacity, full software 
compatibility and more compact design, RamWorks III is a generation ahead 


RamWorks III is the newest 3rd 
generation RAM card for the Apple Ie. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease of use. A design so advanced it’s 
patented. We call it RamWorks IIL, you'll 
call it awesome! 


The AppleWorks Amplifier. 

While RamWorks III is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you’d expect RamWorks III to 
expand the available desktop, after all 
Applied Engineering was a year ahead of 
everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and only RamWorks III 
does. With a 256K or larger RamWorks 
IIL, all of AppleWorks (induding printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 


Only RamWorks eliminates Apple- 
Works’ intemal memory limits, increasing 
the maximum number of records avail 
able from 1,350 to over 25,000. Only 
RamWorks increases the number of lines 
permitted in the word processing mode 
from 2,250 to over 15,000. And only 
RamWorks offers a built-in printer buffer, 
so you won't have to wait for your 
printer to stop before returning to Apple- 
Works. RamWorks even expands the 
clipboard. And auto segments large files 
so they can be saved on two or more 
disks. You can even have Pinpoint or 
MacroWorks and your favorite spelling 
checker in RAM for instant response. 

RamWorks, nothing comes close to 


enhancing AppleWorks so much. 


The Most Friendly, Most 
Compatible Card Available. 


Using RamWorks III couldn't be easier 
because its compatible with more off 
the-shelf software than any other RAM 
card. Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard- 
Soft, FlashCalc, Pro-Filer, Managing Your 
Money, SuperCalc 3a, and MagiCalc to 
name a few (and af hardware add on’s 
like ProFile and Sider hard disks). Ram- 
Works is even compatible with software 
written for Apple cards. But unlike other 
cards, RamWorks plugs into the Ile 
auxiliary slot providing our super sharp 
80 column text (US. Patent #4601081) in 
a completely integrated system while 
leaving expansion slots 1 through 7 
available for other peripheral cards. 

RamWorks III is compatible with all 


Apple Ile’s, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of- 
fered the largest memory for the IIe and 
RamWorks II continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 meg is about 500 
pages of text)...but if you do ever need 
more than 1 MEG, RamWorks III has the 
widest selection of expander cards avail- 
able. Additional 512K, 2 MEG, or 16 
MEG cards just snap directly onto Ram- 
Works II by plugging into the industry’s 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 

If you’ve got some other RAM card 
thats not being recognized by your 
programs, and you want RamWorks IIL, 
you're in luck Because all you have to 
do is plug the memory chips from your 
current card into the expansion sockets 
on RamWorks to recapture most of your 
investment! 


The Ultimate in RGB Color. 

RGB color is an option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don’t need RGB and for those that 
do. Because if you don’t need RGB 
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Applied Engineering doesn’t make you 
buy it, but if you want RGB output 
you're in for a nice surprise because the 
RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 
composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 
claim is the best they have ever seen. 
You'll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB 
option is more than just the ultimate in 
color output because unlike others, it's 
fully compatible with all the Apple 
standards for RGB output control, mak- 
ing it more compatible with offthe-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 
option provides both Apple standard and 
IBM standard RGB outputs (cables in- 
cluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- 


RGB Option 


ference and remember you can order 
the RGB option with your RamWorks or 
add it on at a later date. 


True 65C816 16 Bit Power. 

RamWorks III has a built-in 65C816 
CPU port for direct connection to our 
optional 65C816 card The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 
tions like running the Lotus 1-2-3™ 
compatible program, VIP Professional. 
Our 65C816 card does not use another 
slot but replaces the 65C02 yet maintains 
full 8 bit compatibility. 
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With a RamWorks in your Apple, you'l 


Endorsed by the Experts. 
A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks... 
like the product so much that I am 
buying one for my own system.” inCider 
magazine said “RamWorks is the most 


“T wanted a 
memory card for 
my Apple that was 
fast, easy to use, 
and very compat. 
_ ible; so I bought 
RamWorks.”’ 


Steve Wozniak, the creator 
of Apple Computer 


powerful auxiliary slot memory card 
available for your Ile, and I rate it four 
stars...For my money, Applied Engineer- 
ing’s RamWorks is king of the hill” 
Apple experts everywhere are im- 
pressed by RamWorks’s expandability, 
versatility, ease of use, and the sheer 


power and speed that it adds to any Ile. 


make IBM PCs and AT’s look like 
slowpokes. 


Quality and Support of the 
Industry Leader 

RamWorks III is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 
the inventor of large RAM cards for the 
Apple. With our 5 year no hassle 
warranty and outstanding technical sup- 
port, you're assured of the most trouble 
free product you can buy. 


Its Got It All 
e 15 day money back guarantee 
e 5 year hassle free warranty insures 


coverage nO matter where you 
purchase 

e Built-in super sharp 80 column display, 
(US. Patent #4601081) 

e Expandable to 1 MEG on main card 

e Expandable to 16 meg with expander 
cards, with NO slot 1 interference 

e Can use 64K or 256K RAMs 

e Powerful linear addressing 16 bit 
coprocessor port 

e Automatic AppleWorks expansion up 
to 3017K desktop 

e Accelerates AppleWorks 

e Builtin AppleWorks printer buffer 

e The only large RAM card that’s 100% 
compatible with all Ile software 

e RamDrive™ the ultimate disk emula- 
tion software included free 

e Memory is easily partitioned allowing 
many programs in memory at once 

e Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 
both Apple and IBM type monitors 

e Built-in self diagnostics software 

e Lowest power consumption (US. 
Patent #4601081) 

e Takes only one slot (auxiliary) even 
when fully expanded 

e Socketed and user upgradeable 

e Software industry standard 

e Advanced Computer Aided Design 

e Used by Apple Computer, Steve 
Wozniak and virtually all software 
companies 

e Displays date and time on the Apple- 
Works screen with any PRO-DOS 
compatible clock 

e Much, much more! 


RamWorks Ill with 64K 
RamWorks Ill with 256K 
RamWorks Ill with 512K 
RamWorks Ill with 1 MEG 
RamWorks Ill with 1.5 MEG 


$179 
$219 
$269 
$369 
$539 


RamWorks ili with2to16MEG CALL 


65C816 16 Bit Card 

RGB Option 

Optional Software: 

Pinpoint with RAM 
Enhancement Software 

VIP Professional 


$159 
$129 


$79 
$219 


RamWorks III. The industry standard 
for memory expansion of the Apple Ile. 

ORDER YOUR RamWorks III TODAY. 
9 am. to 11 p.m. 7 days, or send check 
or money order to Applied Engineering 

MasterCard, Visa and CO.D. welcome. 
Texas residents add 5%% sales tax. Add 
$10.00 if outside USA 


A. Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 


DE84- 78 2250 SEI Disable IRQ's 


DE85- 4E 9B BF 2260 LSR MLI-.ACTIVE.FLAG Clear this flag 
DE88- 68 2270 PLA Get saved status 
DE89- AA 2280 TAX and keep it in X-reg 
DESA- fp 9D BF 2290 LDA MLI.RETURN+1 
DES8D- 2300 PHA Put return address on stack 
DE8E- AD 9C BF 2310 LDA MLI. RETURN 
DE91= 48 2320 PHA 
DE92- 8A $330 TXA Now push the status for RTI 
DE ae 48 2340 PHA 
DE94- 98 2350 TYA Get error code in A-reg 
DE95- AE 9E BF 2360 LDX MLI.X Restore X and Y 
DE98- AC 9F BF 2370 LDY MLI.Y 
DESB- 48 2380 PHA Error code on stack 
DE9C—- AD F4 BF 2390 LDA E000. BYTE 
DEQF- 4C AO BF SNe , JMP LC.BRIDGE. EXIT 
2420 *  LC.BRIDGE.EXIT is code at $BFAO in 
2430 ® the system global page. It restores 
2440 # the language card to the state it 
a was in when JSR $BFO0 was exectuted. 
2470 # LC.BRIDGE.EXIT EOR $E000 
2480 # EQ .1 BFAA 
2490 & STA $CO 
2500 # BNE .2 BFB5 
2510 * .1 LDA DOOO.BYTE $BFF5 
2520 & EOR $D000 
2530 # BEQ .2 BFB5 
2540 & LDA $C083 
2550 * .2 PLA 
2560 : RTI 
2570 #----~~---~~------~-+-+--~--~---- 
2580 ERR. NO. ayer 
DEA2= AQ 28 2590 #$28 "NO DEVICE CONNECTED" 
DEA4- 20 09 BF 2600 isk CALL. SYSERR 
2610 ERR.CALL.NO 
DEAT= AQ O1 2620 LDA #1 "BAD CALL TYPE" 
DEAQ=- DO 02 2630 BNE DEAD 
2640 ERR. PARM.CNT 
DEAB- AQ O4 2650 LDA #4 "BAD PARAMETER COUNT® 
DEAD- 20 D7 DE 2660 DEAD JSR CALL.CALL.SYSERR 
DEBO- BO C =e r P BCS EXIT.TO.CALLER ...ALWAYS 
2690 BLOCK.IO.SETUP 
DEB2= AO 05 2700 LDY #5 COPY REST OF COMMAND BLOCK 
DEB4- 08 2710 PHP FROM IOB TO ZERO-PAGE 
DEB5- 78 2720 SEI D Yt ALLOW IRQ'S 
DEB6- B1 40 othe -1 LDA oe. PNTR 
DEB8- 32 42 00 2740 STA COMMAND, Y 
DEBB- 2750 DEY 
DEBC=- DO F8 2760 BNE .1 
DEBE=- A6 45 AS LDX BUFF. PNTR+1 
DECO=- 86 4F 2780 STX GEN. PNTR2+1 
DEC2- E8 2790 INX 
DEC3—- E8 2800 INX 
DEC4H- AS 44 2810 LDA BUFF. PNTR 
DEC6—- FO 01 2820 BEQ .2 
DEC8- E8 2830 INX 
DEC9= 20 OF FC 2840 .2 JSR CHECK. IF.MEM.FREE 
DECC=- BO 08 3800 BCS sp -- NOT FREE 
DECE~- 20 DA DE 2860 JSR BLOCK.IO 
DED1=- BO 03 2870 BCS .3 ---1/0 
DED3= 28 28 80 PLP RESTORE” Tho *STATUS 
DED4- 18 2890 CLC NO ERRORS 
DED5- 60 2900 RTS 
2910 S2enees- 65 cheese cheese ses 
DED6- 28 2920 .3 PLP RESTORE IRQ. STATUS 
DEDT=- 20 09 BF 3 ae CALL. CALL.SYSERR JSR CALL.SYSERR 
2950 * (DEDA) DECE ECOA EE83 FOEY F475 callers 
2960 BLOCK.IO 
DEDA=- A5 4 2970 LDA UNIT.NO Clean this up a little 
DEDC=- 29 F 2930 AND #$F0 
DEDE- 85 43 2990 STA UNIT.NO 
DEEO=- 4A 3000 LSR Make it into index too 
DEE1—= 4A 010 LSR 
DEE2= 4A 020 LSR 
DEE3- AA 3030 TAX 
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LDA DRIVER. ADDR. TABLE, X 
STA JUMP 

LDA DRIVER. ADDR. TABLE+1.X 
STA JUMP+1 

JMP (JUMP) 


w 
o] 
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12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 


All new 1984 design incorporates the 
latest in state-of-art 1.C. technologies. 


Complete 12 bit A/D converter, with an 
accuracy of 0.02%! 


16 single ended channels (single ended 
means that your signals are measured 
against the Apple’s GND.) of 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

9 software programmable full scale 
ranges, any of the 16 channels can have 
any range at any time. Under program 
control, you can select any of the 
following ranges: t 10 volts, +5V, 
+2.5V, +1.0V, tSOOMV, + 250MV, 

+ 100MV, +SOMV, or +25MV. 

Very fast conversion (25 micro seconds). 


Analog input resistance greater than 
1,000,000 ohms. 

Laser-trimmed scaling resistors. 

Low power consumption through the 
use of CMOS devices. 

The user connector has +12 and -12 
volts On it sO you Can power your 
sensors. 

Only elementary programming is 
required to use the A/D. 


@ The entire system is on one standard 


size plug in card that fits neatly inside 
the Apple. 


System includes sample programs on 


diek: PRICE $319 


A few applications may include the moni- 


toring of @ flow @ temperature @ humidi- 


ty © wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ soil mois- 
ture and many more. 


oo Oo0O Seo oOo" 


210 


-OR $FD65 
-TA $800 
COMMAND. HASH. TABLE 


-HS D3.00.00.00.40.41.00.00 
-HS 80.81.82.65.C0.C1.C2.C3 
~HS C4.C5.C6.C7.C8.C9.CA.CB 


-HS CC.CD.CE.CF.00.D0.D1.D2 
PARM. CNT. TABLE 


-HS 02.FF.FF.FF.02.01.FF.FF 
-HS 03.03.00.04.07.01.02.07 
-HS 0A.02.01.01.03.03.04.04 


-HS 01.01.02.02.FF.02.02.02 


220 § Macnee neon manawa es sees eeeeosone 


A/D & D/A 
A/D & D/A Features: 
@ Single PC card 
@ 8 channels A/D 
@ & channels D/A 
@ Superfast conversion time 
@ Very easy programming 
@ Many analog ranges 
@ Manual contains sample applications 


A/D SPECIFICATIONS 

@ 0.3% accuracy 
@ On-buard memory 
@ Fast conversion (.078 MS per channel) 
@ A/D process totally transparent to 

Apple (looks like memory) 
@ User programmable input ranges are 

0 to 10 volts, 0 to 5, —5 to +5, —2.5 

to +2.5, -5to0, -10 to 0. 
The A/D process takes place on a continuous, 
channel sequencing basis. Data is automatic- 
ally transferred to its proper location in the 
on-board RAM. No A/D converter could be 
easier to use. 


D/A SPECIFICATIONS 

@ 0.3% accuracy 
@ On-board memory 
@ On-board output buffer amps can 

drive 5 MA 
@ D/A process is totally transparent to 

the Apple (just poke the data) 
@ Fast conversion (003 MS per channel) 
@ User programmable output ranges are 

0 to & volts and 0 to 10 volts 
The D/A section contains 8 digital to analog 
converters, with output buffer amplifiers and 
all interface logic on a single card. On-card 
latches are provided for each of the eight 
D/A converters. No D/A converter could be 
easier to use. The on-board amplifiers are 
laser-trammed during manufacture, thereby 
eliminating any requirement for off-set 


nulling PRICE $199 


We Make Measurement And Control Easy! 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is designed tor use with both our A/D converters. This 
board incorporates 8 F.E.T. op-amps, which allow almost any gain or offset For example, 
an input signal that vasies trom 2.00 to 2.15 volts of a signal that varies trom 0 to 50 
mV can easily be converted tu 0-10V output for the A/D. 


The signal conditioners outputs are on a high quality 16 pin gold IC. socket that 
matches the one on the A/D's so a simple ribbon cable connects the two. The signal 
conditioner can be powered by your Apple of from an external supply. 


FEATURES 

@ 4.5” square tor standard card cage and 4 mounting holes for standard mounting, The 
signal conditioner does not plug into the Apple. ic an be located up to % mile away from 
the A/D. 


@ 22 pin .156 spacing edge card input connector (extra Connectors are easily available i.e. 
Radio Shack). 


@ Large bread board area. 
@ Full detailed schematic included. 


PRICE $79 


/O 32 


@ Provides 4, 8-Bit programmable 1/0 
Ports 


@ Your inputs can be anything from 
high speed logic to simple switches 


@ Any of the 4 ports can be pro 
grammed as an input of an output 


pon 


@ Ali 1/O lines are TTL (0-5 volo 
compatible 


@ Programming is made very easy by 
powerlul on-board firmware 


@ The I/O 32 is your best choice for any 
control application 


The I/O manual includes many programs for inputs and outputs. 


Some applications include: 
Burglar alarm, direction sensing use with relays to turn on lights, sound buzzers, start 
motor, control tape recorders and printers, use with digital joystick 


PRICE $89 


Please see our other tull page ad in this magazine foc information on Applied Engineering's Timemaster (tock Card and other products for the Apple. 
Our boards are far superior to most of the Consumer electronics made today. AlLLC.’s are in high quality sockets with mil-spec. components used throughout. P.C. boards are glass epoxy 
with gold contacts. Made in America to be the best in the world. All products Compatible with Apple It and //e. 
Applied Engineesng’s products are fully tested with complete documentation and available for immediate delivery. All products are guaranteed with a no hasslv three year warranty. 
Texas Residents Add 5% Sales Tax Send Check or Money Order tu: Call (214)241-6060 
Add $10.00 If Outside U.S.A. APPLIED ENGINEERING 9am. toll p.m. 7 days a week 
P.O. Box 796 MasterCard, Visa & C.0.D. Welcome 
Carrollton, TX 75006 No extra charge for credit cards 
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Another Update to Bob's ProDOS Program Selector 
---e-Bob Sander-Ceder lof 


The following refers back to the new ProDOS Quit Code I wrote 
and published in the July 86 issue of AAL. It has been very 
popular, judging from the number of letters and phone calls we 
have received. 


Eric Trehus (T'n'T Software) pointed out that I ignored one or 
more of the conventions Apple established for Quit-Code Program 
Selectors. On page 87 of the ProDOS Technical Reference 
Manual, the paragraph with number 2 states that the name of the 
system program should be stored in a buffer at $280, starting 
with a length byte. The first paragraph on page 88 says any 
non-standard Quit Code must begin with a CLD instruction, s0 
programs can tell who loaded them. 


If you want the CLD instruction there, go ahead and insert one 
between lines 1310 and 1320- I have not found it necessary for 
any programs I uSe. 


Eric says that when going from BASIC.SYSTEM to APLWORKS.SYSTEM 
he needed the program name stroed in $280. I have never run 
into the problem, but it is easy to fix. Eric suggested 
inserting the following two lines: 


2065 STA $280 
2125 STA $280,Y 


(Eric's change takes six bytes, so you need to be sure the code 
still fits in $300 bytes. |] 


If you do it Eric's way, only the name of the system file gets 
stored, without any prefix. I wondered whether or not a full 
pathname should be there, so I consulted Gary Little's “Apple 
ProDOS--Advanced Features* book. On page 141, near the bottom, 
he says either a full or a partial pathname should be put at 
$280. We can get the full pathname into $280 without Eric's 
two lines, by simply changing line 4860 from “PATHNAME .BS 64" 
to "“PATHNAME .EQ $280". This is my preference. 


When I was trying out the above, I stumbled across a problem. 
If my Selector finds no SYS or DIR files in a directory, it 
still displays the pathname and prompt messages. If you then 
type the RETURN key. it may try to execute garbage, or try 
various other things. The only valid keystroke when no files 
are listed is ESCAPE, which will take you back to the list of 
volume names. Adding two lines makes it go there without 
displaying the empty list: 


1771 TXA see if any files listed 
1772 BEQ -2 ...none listed, start over 


We noticed the other day that when we ran Erv Edge's correction 
to my program (Aug 86, page 1), we reversed the information. 

We said change line 3390 from BNE .1 to BPL -l; actually, it is 
the other way around: change from BPL to BNE. Most of you 
figured that out already, but we are sorry for the confusion. 
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Beginning to Peek at the //gs Monitor.....Bob Sander-Cederlof 


The //gs Monitor has a lot of new features not found in any 
earlier model Apple. Unfortunately, you do not get any 


documentation about the monitor with your machine! Next year 
you will be able to buy a book that will tell you about it, but 
who wants to wait? 


If you go into the monitor and try some of the old commands, 
you will find that most of them work. Memory display now shows 
an additional two digits of address, the bank number, and then 
a Slash and the rest of the address. You can enter addresses 
the same way, so you can display any memory in the entire 
l6-megabyte range. For example, to disassemble ROM inside the 
monitor at SFDFO. type “FF/FDFOL“. To look at the range of 
memory in bank FE from 0 to FF, type “FE/0.FF“ and a <RETURN>. 
Note that the disassembler output looks a little different now. 
There are no dollar signs for hex values, and all opcodes for 
the 65816 are disassembled. Also note that in memory range 
display, you get both hex and ASCII values for each byte. If 
you are in 80-column mode, range display shows 16 bytes per 
line rather than only 8. 


The new monitor preserves almost all the standard entry points, 
so they are clues to deciphering the rest. Looking at the 
routines TOSUB (FF/FFBE) and NXTITM (FF/FF73) I found the new 
addresses for the command character and branch tables. The 
command characters are in coded form at FF/F98B and following, 
and the branches are at FF/F9AE and following. There are 35 
commands now, a fact learned by the disassembly of NXTITM. 


I wrote a program to decipher the contents of these two tables 
and print the results. It takes a little work, because the 
characters in the table are not in ASCII. They correspond to 
ASCII values exclusive-ORed with $B0O and diminished by $89, 
which takes place inside the GETNUM subroutine (FF/FFA7). The 
addresses are the low-bytes only of entry points in page SFE of 
bank SFF (FF/FExx). These addresses must be incremented by one 
to get the real entry points, because TOSUB uses them by 
pushing them on the stack and doing an RTS. Anyway, the 
following program does all the unraveling for you, and prints 
35 lines of commands in the order they appear in the tables, 
showing the entry points for each. 


Lines 1110-1170 are an overall loop which runs 35 times, to 
print the 35 commands. The rest is a subroutine to print one 
command. By removing the stars from lines 1210-1230, you can 
get the output in two columns. An advantage to this is that it 
all fits on one screen. 


1010 Speen oe ew nw ewww nw wee 
FDED- 1020 COUT -EQ $FDED 
FDDA- 1030 PRBYTE .EQ $FDDA 
FD8E- 1 : CROUT -EQ $FD8E 
F98B- 1060 LTRS -EQ $F98B Encoded Table of Letters 
F9AE- 1° : ADR. LO -EQ $F9AE Command starts at $FExx+1 
: ? -OP 65816 
1110 PRINT.MONITOR.COMMAND. TABLE 
000800- AO 00 1120 LDY #0 
000802- 20 OD 08 1130 .1 JSR PRINT.ONE.COMMAND 
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Insist on GSRAM’" 
When You Buy Your IIGs’ 


Expand the IIcs RAM and ROM with the GSRAM or GSRAM Plus 
with ROM Pak Available now with 256K to 8 MEG! 


Raabe: the 16K cards for the II+ and 
the 64K cards for the Ile? At the time, that 
much memory seemed like a lot But when 
the owners of these memory cards came to 
us for more memory, many had to throw 
away their smaller Apple memory cards or try 
to sell them Most of our customers told us 
that had they known about Applied Engi- 
neering’s larger memory cards when they 
bought their Apple, they would have pur- 
chased them at the same time. 

GSRAM and GSRAM Plus are available now, 
allowing up to 8 MEG of memory expansion. 
Thats 8 times the memory capacity of 
Apple’s card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 
Apple’s card: 


; @ Lower cost 


e Has 6 RAM banks (Apple's card has 4) 
e Has memory expansion port 
e Has ROM expansion port 
e No configuration blocks to set 
e No soldered in RAM chips 
e Expandable to 8 MEG 
e Expands AppleWorks intemal limits 
e Built-in Hi-Res self - diagnostic software 
e 5 year hassle free warranty (Apple has a 90 
day warranty) 
e Made in USA 
csRAM for More 
AppleWorks Power 
Only GSRAM and GSRAM Plus eliminates 
AppleWorks internal memory limits, increas- 
ing the maximum number of records avail- 
able from 6,000 to over 25,000 and only cs- 
RAM and GSRAM Plus increases the number 
of lines permitted in the word processing 
mode from 6,000 to over 15,000. And only 


' GSRAM and GSRAM Plus offers a built-in 


printer buffer so you can continue using 


AppleWorks while your printer is printing, Gs- | 


RAM and GSRAM Plus even expand the 

number of lines in the dipboard from 255 to 
2047 and will auto segment large files so they 
can be saved on two or more disks You can 


even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GSRAM Plus will even 
display the time and date right on the 
AppleWorks screen. Nothing comes dose to 
enhancing AppleWorks so much 


Turn Your Ilcs into a Giant 

Simply plug GSRAM into the IIGs memory 
expansion slot and you've got up to 8 mega- 
bytes of RAM at your fingertips—all of it 
instantly and automatically recognized by the 
IIGsS. GSRAM is compatible with all IIcs 
software, including AppleWorks, as well as 
BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 
Grow by Bytes or Megabytes 

We offer GSRAM in two configurations so 
you can increase your memory 256K at a 
time (GSRAM) or a megabyte at a time (Gs- 
RAM Plus). Both offer full compatibility, lower 
cost than other boards, and easy expandabil- 
ity. And both are extremely low in power 
consumption. A fully expanded GSRAM oper- 
ates at only 375 ma, and GSRAM Plus at only 
270 ma (even with 6 megabytes on board!) 
GSRAM—for Normal 
Memory Requirements 

GSRAM is available with 256K, 512K, 1 
MEG or 1.5 MEG of memory already on 
board. If you don’t need the full 1.55 MEG 
now, you can choose a GSRAM with less 
‘| memory and expand it up to 1.5 MEG in the 
| future—or upgrade to GSRAM Plus for a 
small charge. 


“T recommend 
Applied 
Engineering 
products 

©  wholebeartedly.”’ 


Steve Wozniak, the creator 
of Apple Computer 


With an optional piggyback card, you can 
expand GSRAM even higher than 1.5 MEG! 
(Other cards are only expandable to 1 MEG.) 
GSRAM Plus—for Growing 


| by Leaps and Bounds 


GSRAM Plus is the first Apple memory card to 
use | MEG RAM chips on the main board 
Its available with 1 to 6 MEG on board. If 
you don’t need the whole 6 MEG now, you 
can buy a GSRAM Plus with less memory and 
easily expand it in the future. 

GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card. 

Easy Expansion 

Both GSRAM and GSRAM Plus use standard 
RAM chips that are readily available and just 
plug right in So unlike other cards, you'll find 
expanding your GSRAM or GSRAM Plus easy, 
convenient and very economical And with 
our optional ROM expansion module you 
can even increase the IIGs’s ROM space and 
all in just one slot 
Quality and Support of the 
Industry Leader 

Applied Engineering is the largest supplier 
of Apple peripherals in the world. We 
invented the first large RAM cards for the 
Apple. With a 5-year “no-hassle” warranty and 
outstanding technical support, you can be 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for—or retum 
them within 15 days for a full refund. 


GSRAM with 256K 
GSRAM with 512K 
GSRAM with 1 MEG 


GsRAM with 1.5 MEG 
GSRAM with 2-8 MEG 


GSRAM Plus with 1-8 MEG 


Order today! 

See your dealer or call Applied Engineering 
today, 9 am to 11 pm 7 days Or send 
check or money order to Applied Engineer- 
ing MasterCard, VISA and C.O.D. welcome. 
Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A 


HAE APPLIED ENGINEERING” 
The Apple enbancement experts. 
(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


CP/M is a registered trademark of Digital Research, Inc. 
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000805- C8 1140 INY 
000806- CO 23 1150 CPY #35 There are 35 commands in table 
000808- 90 F 1160 BCC .1 
OOO80A- AC 8E FD ay F JMP CROUT 
1190 PRINT.ONE.COMMAND 
1200 #---REMOVE "8®@" FOR 2 COLUMNS-------------- 
1210 ##@ = TYA CHECK IF ODD OR EVEN 
1220 ###  LSR 
1230 ### BCS .0 | 
12N0 Sa nmcnn nn nw nn nme ene enn n meee w wens en ewennnne 
OOO080D- 20 8E FD eae JSR CROUT 
1200 8---TAB 10 SPACES --<---<<-<------ 
000810—- A2 OA et 0 LDX #10 TAB OVER 10 SPACES 
000812= AQ AO 1280 LDA #"* * 
000814— 20 ED FD 1290 .1 JSR COUT 
000817— CA 1300 DEX 
000818~ 10 FA 1310 BPL .1 
1320 #---Convert char to ASCIT-------- 
00081A- BQ 8B F9 1330 LDA LTRS,Y Value from table 
00081D- 3 1340 SEC 
00081E= E9 89 1350 SBC #$89 Reverse process from GETNUM 
000820- 49 BO 1360 EOR #$B0 
1386 noare ee pare char to prone woeene-e 
000822- A2 AO 1380 DX #" * pace before regular chars 
000824—- C9 AD 1330 CMP #$A0 
000826- BO O4 1400 BCS .2. ---not control-char 
000828- A2 DE 1410 LDX #""" Caret before control-chars 
00082A=- 09 40 1420 ORA #$40 Make control-char printable 
Wie #---Print the char--------------- 
00082C- 48 1440 .2 PHA Save char itself 
00082D- 8A 198 TXA Print Space or Caret 
00082E- 20 ED FD 1460 JSR COUT 
000831- 68 ah PLA Print char 
000832- 20 ED FD _—‘1480 JSR COUT 
1490 #---Print the address------------ 
000835- A2 03 1500 LDX #3 PRINT " $FE*" 
000837- BD 47 08 1510 .3 LDA FE,X 
00083A- 20 ED FD _——-1520 JSR COUT 
00083D- CA ‘200 DEX 
00083E- 10 FT 1540 BPL .3 
OOO840- BQ AE FY 1550 LDA ADR.LO,Y 
000843- 1A 1560 INC Add 1 because it needs it 
OOO84A- HC DA FD 126 ‘ JMP PRBYTE 
000847= C5 C6 AYN AO 1590 FE -AS -/EF$ / 


Seeing all the commands is nice, but it would be easier to read 
the list if they were in alphabetical order. I modified the 
program a little, sorted them, and printed them in the order ot 


their ASCII values. Lines 1110-1250 now have two loops. The 
first one goes through the 35 commands, and stores them into 
two “sorting trays". I first emptied one of the "trays", by 


storing zeroes in all 256 locations. Then my SORT.ONE.COMMAND 
subroutine stores the command ASCII code into the "tray“ at the 
position indexed by the ASCII value itself. The address byte 
goes into the other "tray" at the same position. 


When all 35 commands have been placed into the appropriate 
positions in the two trays, I run another loop to print out all 
the non-empty positions. There it is! Simple as can be, they 
are sorted almost instantaneously. 


Then I tried to sort them using the same technique but in the 
order of the addresses. This did not work, because some 
addresses are used by more than one command. Only the last 
command uSing a particular address printed out. Sigh.... 


tose eave s.moncmds. sort 


ae 1838 Stldee - BS FERRE 
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000832- B9 AE F9 LDA ADR.LO.Y 


F98B- 1060 LTRS -EQ $F98B Encoded Table of Letters 
F9AE- i. : ADR.LO -EQ $F9AE Command starts at $FExx+1 
1090 -OP 65816 
100 Benn nnn on nn ew wn ee ee eee eee 
110 PRINT. IIGS.MONITOR. COMMANDS. SORTED 
000800- 20 1D 08 120 JSR CLEAR. SORTING. TRAY.A 
000803=- AO 130 LDY #0 
000805- 20 26 08 140 .1 JSR SORT.ONE.COMMAND 
000808- C8 150 INY 
000809- CO 2 160 CPY #35 There are 35 commands in table 
OOO80B- 90 F 170 BCC . 
180 #---Print the commands----------- 
OOO80D= AO 00 190 LDY #0 
OOO80F=- BY 72 08 200 .2 LDA SORTING. TRAY.A,Y 
000812- FO 0 210 BEQ .3 
Ag a 3A 08 see 3 oe PRINT.ONE.COMMAND 
SHE HE Se ERB edons 
940. Watedelce ooo eeecee tees se ccoeee 
oie CLEAR.SORTING.TRAY.A 
00081D= A2 00 280 LDX #0 
00081F= 9E 72 08 290 .1 STZ SORTING. TRAY.A.X 
000822- E8 300 INX 
SooRo8- bo FA 230 RIS 
0 Mewseveco acct Sees eeeeceeeeeeoas 
#6 SORT . ONE . COMMAND 
50 #---Convert char to ASCII-------- 
000826=- B9 8B F9 60 LDA LTRS.Y Value from table 
a 2 if SEC 
OO ORL ig a2 a oe : + Reverse process from GETNUM 
O0082E- AA 00 TAX It is the sorting index 
O0082F- 9D 72 08 aa ‘ STA SORTING. TRAY.A,X 
0 
000835- 1A io INC 
oe oe Te 09 20 ore SORTING. TRAY.B,.X 
0. Sacsectcocoseesueeseee et eeetese 
fo PRINT.ONE.COMMAND 
00083A=- 20 8E FD 90 JSR CROUT 
00 #---TAB 10 SPACES --<--<----------- 
00083D=- A2 OA 10 LDX #10 TAB OVER 10 SPACES 
00083F=- AQ AO 20 LDA #* 
ace ne a ED FD 30 1 JSR COUT 
000845- 10 FA 0 BPL .1 
0 #---Convert char to ASCII----<---- 


000847- B9 72 08 
OOO84A= A2 AO 


LDA SORTING. TRAY.A,Y 
#-.-Prepare char to abet eee noee- 
LDX #*" * pace before regular chars 


OOO84C- C9 AO CMP #$A0 

OOO84E- BO O4 BCS .2. --.not control-char 

000850- A2 DE LDX #""* Caret before control-chars 

000852- 09 40 ORA #$40 Make control-char printable 
#2--Print the chare----<---------- 

000854— 48 -2 PHA Save char itself 

000855- 8A TXA Print Space or Caret 

000856= 20 ED FD JSR COUT 

000859- 68 PLA Print char 


00085A- 20 ED FD 


JSR COUT 
#.--Pprint the addreSs-----------— 
00085D- A2 03 LDX #3 


PRINT * $FE" 


me cee cme cach eh cet cath cme eh ce ee ce cet ee el cee eel ce meee cee ee ee eB cee ce we ch meh me ee re meh ee eh me eh ce ce me ek med eh we ce cee ce ee ee me eth we ee ee eh ce ce ee ch wee eh ee wee eh eth ed od ed ds 
C000 CO 9 9 II I BHAA AAAHAADW OWA AUSTUOTOIIOIION I 2 eo ES BS PS PWD Ww) 


N= OW ON QA BWA | OW CO Qa EW NN Ow ONO 


wlolololelelolololelololololelolololoefalolelelololo) 


00085F- BD 6E 08 3 LDA FE,X 

000862- 20 ED FD JSR COUT 

000865- CA DEX 

000866- 10 F7 BPL .3 

000868- B9 72 09 LDA SORTING. TRAY.B,Y 
OO0O086B- 4C DA FD : JMP PRBYTE 

OOO86E- C5 C6 AX AO FE -AS -/EF$ / 

000872- SORTING. TRAY.A .BS 256 
000972- SORTING. TRAY.B .BS 256 
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With the TransWarp™ accelerator, your He™or II+™ 
is 40% faster than the IIcs! 


Computing at warp speed! 

It’s an experience you shouldn't miss. And with TransWarp, 
you won't have to. Because TransWarp will run your [le or 
H+ software 3.6 times faster — that’s 40% faster than 
Apple's Ics! 

No more yawning while your Apple™ slowly rearranges 
text or calculates spreadsheets. With 256K of ultra-fast RAM, 
TransWarp speeds up all Apple software — including Apple- 
Works, and all educational software, graphics and games. And 
it's compatible with all standard peripheral cards (such as Ram- 
Works and Apple memory cards), hard disks, 342” UniDisks, 
80-column cards, modems, clock cards, Mouses and more! You 
name it, TransWarp accelerates it. There's even a 16 bit upgrade 
chip available. 


“TransWarp is great! I bave 
replaced all my other 
accelerators with it!” 


Steve Wozniak, the creator 
of Apple Compiter 


With TransWarp, software runs up to three times faster than 
with other cards, since the others can’t accelerate programs in 
auxiliary memory. That's why TransWarp is so much faster than 
the rest. Nearly all of today’s more powerful programs run par- 
tially or completely in auxiliary memory: programs like Apple- 
Works, Pinpoint, Managing Your Money, SuperCalc 3a, BPI and 
Pascal, to name a few. Why settle for a card that accelerates 
only part of the memory? 

There’s one more important difference. Since TransWarp 
doesn’t use memory caching, vou get consistent high speed 
performance. 

A cinch to use. 


Simply plug TransWarp into any slot in your Apple IE, I+ or 
fle — including slot 3 in the He. Instantly you'll be computing 


at speeds you only dreamed about before. And should you 
ever wish to run at normal speed, simply press the ESC key 
while tuming your Apple on. 

Since TransWarp is completely transparent, you won't need 
preboot disks or special software. It's ready to go right out of 
the package! 

Speed = Productivity 

Imagine the productivity gains you'll achieve when your 
programs are running over three times faster. TransWarp 1s so 

»werful, your Apple will make [BM PCs™ and even ATs™ 
ook like slowpokes. 


° 3.6 MHZ 65C02 * Totally transparent operation 
© 256K of ultra-fast on-board with all software 
RAM * Plugs into any slot, including 
* Accelerates main and slot 3 on the Apple Ile 
auxiliary memory * Accelerated 16 bit option 
¢Low power consumption for — available 


cool operation 
Satisfaction guaranteed! 
Give your Apple the TransWarp advantage. With our risk-free 


15-day money back guarantee, you have nothing to lose but 
wasted time. Call today! 


°5-vear warranty 


TransWarp accelerator ....0 0000000 cee eee eee . . $279 
16 bit upgrade (may add later) 2.00. ...00.0 00.00.28. ... $89 
For fast response: 


Call Applied Engineering, 9 a.m. to 11 p.m., 7 days at (214) 
241-6060. MasterCard, VISA and C.O.D. welcome. Texas fesi- 
dents add 5%% sales tax. Add $10.00 if outside U.S.A. Or mail 
check or money order to Applied Engineering, PO. Box 798, 
Carrollton, TX 75006. 


Fa al Applied Engineering 
The Apple enbancement experts. 


PO. Box 798, Carrollton, TX 75006 (214) 241-6060 
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Corrections to HR to DHR Converter 
David Johnson just called to point out a couple of corrections 
to his program that converts hi-res graphic images to double 


hi-res. First, we somehow managed to lose a line of his code. 
You need to add this line: 


2435 LSR XLATE.MONO.AUX,X 

Another spot to change is line 2120. The LDA #$03 should 
really be a LDA #$02, since 3 specifies a full color image and 
2 specifies black and white. David reports that 3 has always 
worked OK for him, so this may not make a real difference, but 
the specification (ProDOS Technical Note #13) calls for a 2. 
An error also crept into the text. Near the end of the fourth 
paragraph the article says that the AUXMEM portion of the 
picture is copied into main memory at S$4000-5FFF. What the 
program really does is copy main memory from $2000-3FFF to 


S4000-5FFF, and then transfer the AUXMEM segment into main 
memory at $2000-3FFF. 


a 5 oft. 


Basic-like macros for the S-C Macro Assembler. 
Available for the Apple If, I+, //e, and //c. 

Uses whatever DOS your S-C Macro Assembler uses. 
Soon to be released for PRODOS. 

Source code included with every disk!!! 

Cost? A paltry $50.00!!! 


To Order — Send Check or Money Order to: 


PR Mark Manning 


Simul | 
Bisgu Gane c/o Baggy Games 


P.O. Box 591894 
Houston, Texas 77259-1894 


Apple is a registered Trademark of Apple Computer Inc. 
The S-C Macro Assembler is produced by The S-C Software Corporation. 
EnterSoft is produced by Mark Manning/Simulacron !/Baggy Games 
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Demo of Two Simple //gs Tools..... ge aesiees .-Bob Sander-Cederlof 


The (798 Toolbox is chock full of useful tools, and no doubt 
you have heard about a lot of them by now. However, all of the 


books and articles I have found so far just describe the tools, 
without showing any actual addresses or tool numbers so they 
can be called. Most frustrating! 


If you remember the article last month about reading and 
writing the battery RAM in the //gs, you will remember the 
general way all tools are called. You must be in full-16 
native mode, set up the stack in just the right way, put a tool 
code in the X-register, and do a JSL $E10000. 


The tool code is made up of two bytes. The low-order byte is 
the tool set number, and the high-order byte is the tool number 
in that tool set. One of the missing items of information in 
most documentation I have seen so far is the list of tool set 
numbers. As near as I can figure it all out at this time, the 
following numbers seem to be established: 


$01 Tool Locater itself 
$02 Memory Manager 
$03 Miscellaneous Tools 


$04 Graphics Core (QuickDraw?) 
$05 Desk Manager 


$06 Event Manager 

$07 Scheduler 

$08 Sound Manager (Ensonig stuff) 

$09 Front Desk Bus 

SOA SANE (Fancy Floating Point stuff) 
SOB Integer Math 

SOC Text Tools 

SOD <<<I don't know>>> 


SOE-$20 Various RAM-based tools 


The first eight tools in every tools set are all the same, and 
do not seem to be too important to the casual user. They 
include boot initialization code, version and status 
information, reset, and so on. Even a couple of Spares. 


Of interest to this article, tool number $2A in set SOB will 
convert a two-byte value to a four-character ASCII string. For 
example, $12AF would be converted to the four bytes $3l, $32, 
$41, $46. These are the ASCII values for the four hexadecimal 
digits of S12AF. Lines 1090-1170 in the following program use 
this tool- Note that all inputs and outputs for the tool are 
handled through the stack. 


Tool $20 of tool set $OC will print out a string in ASCIIZ 
format. ASCIIZ is a new term to me, which I discovered this 
week in the Microsoft book “Advanced MS-DOS“. It means a 
string of ASCII characters terminated by a 00 byte. After 
lines 1140-1170 have placed the ASCII form of the number we 
converted into the four bytes at HEX (line 1290), we have an 
ASCIIZ string starting at MSG (lines 1280-1300). Pushing the 
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NEW!!! If INAMAC: $69.00 
This Apple I! emulator runs DOS 3.3 and PRODOS programs (including 6502 machine language routines) on a 512K 
Macintosh. All Apple !I| features are supported such as HI-RES/LO-RES graphics, 40/80 column text screens. 
language card and joystick. Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk 
accessories and support for 4 logical disk drives. Package includes 2 MAC diskettes (PROGRAM holds emulation, 
communications and utility software, DATA holds DOS 3.3 and PRODOS system masters, including Applesoft and 
Integer BASIC) and 1 Apple I! diskette (transfer software moves disk images to the MAC). 


NEW !!! SCREEN.GEN: $35.00 
Develop HI-RES screens for your Apple Il on a Macintosh. Dont be limited by MousePaint or other screen 
editors. Use MACPAINT (or any other application) on the MAC to create your Apple Il screen. Then use 
SCREEN.GEN to transfer directly from the MAC to the Apple I! (with SuperSerial card or equivalent). Package 
includes Apple || diskette with transfer software plus fully commented SOURCE code. 


NEW !!! MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MiDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-MAGIC compatible 
with Apple II family using Passport MIDI card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Ue with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. Special printer functions (like expanded, compressed etc.) 
supported. HIRES screen editor lets you create your own characters and special graphics symbols. For Apple Il, 
li+, //e. Specify printer: Apple Dot Matrix, C.ltoh BS10A (Prowriter), Epson FX 60/100, or OkiData 92/93. 

* The Font Downloader & Editor for the Apple Imagewriter Printer. For use with Apple Il, 
li--, //e (with SuperSerial card) and the Apple //c (with builtin serial interface). 

+ FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
Si pported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Ue this intelligent disassembler to investigate the inner workings of Apple Il machine language programs. 
{- 3ASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
e semblers. Handles data tables, displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 
Converts a ‘dumb’ parallel printer |/F card into a ‘smart’ one. Command menu eliminates need to remember 
complicated ESC codes. Features include perforation skip, auto page numbering with date & title. Includes large 
HIRES graphics & text screen dumps. Specify printer: MX-80 with Graftrax-80, MX-100, MX-80/100 with 
G: aftraxplus, NEC 8092A, C.ltoh 6510 (Prowriter), OkiData B2A/83A with Okigraph & OkiData 92/93. 
‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation’s Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone 
detection, audible ring detect, ring-back, printer buffer, 60 col card & shift key mod support. 
RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnOO-CnFF and $CG00-CFFF. 
C-PRINT For The APPLE //c: $69.00 
Connect standard parallel printers to an Apple //c. C-PRINT plugs into the standard Apple //c printer serial 
port and into any printer having a standard 36 pin centronics-type parallel connector. Just plug in and print! 


Unless otherwise specified, all Apple I! diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid s $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
CECECEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
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address of MSG onto the stack and calling for tool $200C will 
print out the string on the screen. See lines 1180-1220. 


Line 1190 may need a word of explanation. The tool needs a 
four-byte address on the stack, so line 1190 pushes the 
high-order two bytes of the address. I could have used "PEA 
MSG/65536", but I like "PEA MSG/256/256" better. 


If you have a //gs, try out this little example. It will get 
you started in understanding all the new tools you have in your 
toolbox. If you don't have a //gs yet, start saving your 


nickels! 
1000 *SAVE S.PRINT.DEMO 
1010 # n-ne en ee een eee 
1020 -OP 65816 
1030 T 
000800- 18 1040 cle GO INTO NATIVE MODE 
000801- FB 1050 xce 
000802- C2 33 1060 rep £339 FULL 16 
OOO804=- AQ 12 1070 lda ##$1234 SAMPLE VALUE IN A-REG 


o~ 


1080 #---Tool: convert hex to string------- 
Sea807 Fa 86.03 1933 Fen BETES FON nasuua 
OOO80D- 48 1110 PHA VALUE TO BE CONVERTED 
OOO80E=- A2 OB 2A 1120 LDX ##$2A0B TOOL: HEX=-VALUE TO ASCII 
BODE RE ER ee ylip ae aeaacinas 
000816—- 8D 4E 08 1150 STA HEX INTO STRING 
000819= 68 1160 PLA TWO MORE CHARS 
00081A=- 8D 50 08 te STA HEX+2 INTO STRING 

1180 #---Tool: print a string------~+------- 
00081D=- F4 00 00 1190 PEA MSG/256/256 
000820—- FA 2D 08 1200 PEA MSG ADDRESS OF STRING 
000823- A2 OC 20 1210 LDX Ch ae TOOL: PRINT STRING 
000826- 22 00 00 E1 eee : JSL $E10000 
O0082A- 38 1380 SEC RETURN IN EMULATION MODE 
00082B- FB Moen XCE 
00082C- 60 1260 RTS 

1270 Benn nnn nn m nw wn ww ewww www enw n ne 
O0082D=- 54 48 45 20 
000831- 4E 55 AD 42 
000835- 45 52 20 4 
000839- HE 20 54 4 
00083D=- 45 20 41 2D 
000841- 52 45 HT 49 
So0B4S- 36 hg $3 30 
OOOB4D- 24 1280 MSG -AS "THE NUMBER IN THE A-REGISTER IS $" 
OOO84E- 1290 HEX -BS 4 
000852- OD 00 ee . -HS OD.00 


Woz Re-Codes Hi-Res Address Calculations....Bob Sander-Cederlot 


In the October or November issue of the Washington Apple Pi 
newsletter, Rick Chapman wrote a review of various methods of 
calculating the hi-res base addresses. Steve Wozniak liked the 
article, and responded with a long “letter to the editor" in 
the December issue. Steve also presented a new version of the 
hi-res address calculator which is both shorter and faster. In 
fact, as far as I am aware, it is the fastest method ever, 
except for table-lookups. 


In the September 1983 issue of Apple Assembly Line, I presented 


both the original Woz code and a shorter-faster version by 
Harry Cheung of Nigeria. Here are the specs: 
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With the 
7-80 Plus; run 
over 5000 new 

CP/M’ programs. 


Shy 4 ve 
BeGM4iOd 


Now, get two pet seas 
in one and all the 
advantages of both. 


nter the CP/M world with the new Z-80 Plus card from 

Applied Engineering, and introduce your Apple He, IIcs or 
II+ to thousands of CP/M programs. Only the Z-80 Plus comes 
standard with the new 5.1 software, the most advanced system 
ever for running CP/M programs. 

The new 5.1 boasts advanced features like built-in disk 
emulation for popular memory expansion boards, boosting both 
system speed and storage capacity. And menu-driven utilities that 
let you get to work faster. The Z-80 Plus also lets you run older 
CP/M programs— all the way down to Version 1.6 (2.2 is the 
most popular). 

The 27-80 Plus is the only card on the market capable of 
accessing more than 64K. If you have an extended 80-column 
card, all 128K is usable. And if you have RamWorks, RamFactor, 
csRam, csRam Plus, or an Apple memory card in your Ile, [cs or 
II+, up to 1088K is available. 

Each Z-80 Plus comes with our CP/M Ram Drive software, 
enabling most memory cards to work as a high-speed Ram disk 
so CP/M software can run up to tuenty times faster. So packages 
like WordStar, dBASE 1, Turbo Pascal and most others run at 
blinding speed. 

Simply plug the Z-80 Plus into any slot in your Apple. You'll 
get the benefits of two computers in one—all at an unbelievably 
low price (only $149!). 


e Fully compatible with ALL CP/M software =e _ Fully compatible 
with 5%" and 3%" disk drives as well as most hard disks includ- 
ing the Sider =e Fully compatible with Microsoft disks (no pre- 
boot required) —e Specifically designed for high speed opera- 
tion e@ Runs WordStar, dBASE II, Turbo Pascal, and ALL other 
CP/M software with no pre-boot —e Semi-custom LC. and low 
narts count allows Z-80 Plus to fly through CP/M programs with 
extremely low power consumption (we use the Z-80B) e Does 
EVERYTHING other Z-80 boards do, plus Z-80 interrupts 

e Five-year warranty 


To get your Z-80 Plus or for more information see your 
dealer, or call 214-241-6060 9 am. to 11 p.m. seven days, or send 
check or money order to Applied Engineering. MasterCard, VISA 
and C.O.D. welcome. Texas residents add 5%% sales tax. Add 
$10.00 outside USA 


= Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 


CPM is a regintered trademark of Digttl Research. 
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Ram Factor 


All the Performance, Speed, and Software 
Compatibility of RamWorks” in a Slot 1 through 7 Card. 


Tees. right’ Now Applied Engineering offers you a choice. While RamWorks is the dear 
winner for the auxiliary slot in a Ile, RamFactor is the standard for slots 1 through 7. Now 
anyone with an Apple II+, Franklin, or Apple Ile preferring to use slots 1 through 7 can now 
enjoy the speed and performance that until] now was only available with RamWorks 

With RamFactor, you'll be able to instantly add another 256K, 512K, or a full 1 meg on the 
main board and up to 16 meg with additional piggyback card And since virtually all software 
is automatically compatible with RamFactor, you'll immediately be able to load programs into 
RamFactor for instantaneous access to information. You'll also be able to store more data for 
larger word processing documents, bigger data bases, and expanded spreadsheets 


Very Compatible 

All the leading software is already com- 
patible with RamFactor. Programs like Apple- 
Works, Pinpoint, BPI, Managing Your Money, 
Dollars and Sense, SuperCalc 3A, PFS, Mouse- 
Write, MouseDesk, MouseCalc, Sensible 
Speller, Applewriter He, Business Works, 
ReportWorks, Catalyst 3.0 and more. And 
RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 
and CP/M compatible. In fact, no other 
memory card (RamWorks excepted) is more 
compatible with commercial software. 
AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
intemal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load AppleWorks into RAM 
dramatically increasing speed and eliminating 
the time required to access the program disk, 
it will even display the ime and date on the 
AppleWorks screen with any ProDos dock 
RamFactor will automatically segment large 
files so they can be saved on 5%", 34%", and 
hard disks. All this performance is available to 
anyone with an Apple Ie or II+ with an 80 


column card. RamFactor, no other standard 
slot card comes close to enhancing Apple- 
Works so much. 
True 65C816 16 Bit Power 
RamFactor has a builtin 65C816 CPU port 
for direct connection to our He 65C816 card 
for linearly addressing up to 16 meg for the 
most powerful 16 bit applications. (11+ 
65C816 card under development) 


Powerful Program Switcher 

With RamFactor, you can organize 
memory into multiple work areas and switch 
between them. Each work area can contain 
different programs and even different operat- 
ing systems Now you can switch from one 
program to another or even switch from 
AppleWorks to DOS 3.3 to CP/M to Pascal to 
ProDos in under a second. And with our 
Battery back-up option, you can have 
permanent storage for up to 20 years. 


Quality and Support of the 
Industry Leader 

RamFactor is from Applied Engineering, 
the largest, most well supported manufacturer 
of Apple peripherals and the inventor of large 
RAM cards for the Apple. With our 5 year no 
hassle warranty and outstanding technical 
support, you're assured of the most trouble 
free product you can buy. 


Features: 

e Up to 16 meg total memory, 256K to 1 
meg on main board. Up to 16 meg with 
additional memory on piggyback card. 

e Fully Apple II Memory Expansion com- 
patible 

e Compatible with Apple Ile, II+ and 
Franklin 

e Battery back-up option allows you to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal and CP/M 

e Built-in RamDrive™ software (a tue RAM 
disk not disk caching) 

e Systems are directly bootable from Ram- 
Factor if desired 

e Built-in linear addressing 16 bit 
cOo-processor port 

e Built-in self diagnostic software 

e Automatic expansion with AppleWorks 1.3 
or later 

e Allows Apple II+ and Ie to run your 
AppleWorks without buying additional 
software 

e Accelerates AppleWorks 

e Displays time and date on the AppleWorks 
screen with any ProDos clock 

e Fits any I/O slot except slot 3 

e Fully socketed and user upgradeable 

e Much, much more 


RamFactor with 256K 
RamFactor with 512K 
RamFactor with 1 MEG 


RamFactor with 2-16 MEG 
Battery Back-up Option 
65C816 16 Bit Card 


Order RamFactor today . . . with 15 day 
money back guarantee and our “no hassle” 
five year warranty. Cal9 am to 11 p.m, 7 
days, or send check or money order to 
Applied Engineering. MasterCard, Visa and 
COLD. welcome. Texas residents add 5%% 
sales tax. Add $10.00 if outside USA 


/AE. Applied Engineering” 
The Apple enbancement experts. 


(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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Applesoft ROM version: 33 bytes, 61 cycles 
Harry Cheung version: 25 bytes, 46 cycles 
New Wozniak version: 26 bytes, 36 or 37 cycles 


The byte counts do not include an RTS at the end of the coae, 
noz do the times include a JSR-RTS. After all, if you are 
really working for speed you will put the code in its place, 
noz make it a subroutine. 


Woz's new version takes either 36 or 37 cycles, depending on 
the values for the first two bits of the line number. Remember 
that the line number can be any value from 0 to 191, or 
$00...SBF. That means the first two bits are either 00, 01, or 
10. If you look at lines 1090-1120 below, you will see that 
th: shortest path is for 00, taking both branches, giving a 

. ruining time for the whole calculation of 36 cycles. If the 
first two bits are 01 or 10, one branch will be taken and the 
other not, making the total time 37 cycles. In Woz's letter he 
shortchanged himself, thinking possibly both branches might not 
be taken, giving a total running time of 38 cycles; this cannot 
happen with legal line numbers. 


Line 1180 adds in either $10 or $20, depending on which hi-res 
page you are uSing. The Applesoft code here adds in a value of 
either $20 or $40, so if this version were to be inserted into 
Applesoft the generation of HPAG2 would have to be changed. No 
priblem, and not likely anyway. By the way, if you are only 
uSing one specific hi-res page, you can change line 1180 to an 
immediate mode form, saving yet another cycle. 


Here is Woz's new version, reformatted for the S-C Assembler 
and with some changes in comments: 


1000 Gg OAVE NEW.WOZ. HIRES .CALC 


a 1020 GBASL EQ $26 

[7s 1030 GBASH .EQ $2 

Eo=- vne6 HPAG2 -EQ $E Applesoft puts it here anyway. 

C800- OA 1060 CALC ASL A--BCDEFGHO 

C801- AA 1070 TAX TAX...TXA could be TAY...TYA 

POC ieoe.. 1p idee phan mimes 

chebe 98 oe. alan eee? mage 

C80A- 80 OA 1120 ORA #$0A A--BCDEABAB 

O80C- OA 1130 2 ASL B--CDEABABO 

O80D- OA 1140 ASL C--DEABABOO 

O80E- 85 26 1190 STA GBASL 

0810- 8A 1160 TXA C--BCDEFGHO 

0811- 29 OF 1170 AND #$0E | C--0000FGHO 

es meas 1199 « PAGE og $10 for base $2000 20 for base $4000 
= or ase or ase 

0815- 06 26 1200 ASL GBASL D--00xxF éntee- =EABABO00 

0817 - 2A 1210 ROL On Ox FGHCD 

0818- 85 27 1220 STA GBASH 

O81A- 60 12 0 . RTS 


Apple Assembly Line (ISSN 0889-4302) is published monthly by S-C SOFTWARE 
CORPORATION, P-O- Box 280300, Dallas, Texas 75228. Phone (214) 324-2050. 
Subscription rate is $18 per year in the USA, sent Bulk Mail; add $3 tor First 
Class postage in USA, Canada, and Mexico; add $14 postage for other countries. 
Back isSueS are available for $1.80 each (other countries add $1 per back 
issue for postage). A subscription to the newsletter and the Monthly Disk 
containing all source code is $64 per year in the US, Canada and Mexico, ana 
$87 to other countries. 
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reserved. (Apple is a registered trademark of Apple Computer, Inc.) 
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